home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / CATAGING / VCRDBASE.LZH / VCRDBASE.DOC < prev   
Text File  |  1980-01-01  |  17KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                         +-------------------+
  8.                         |  V C R D B A S E  |
  9.                         +-------------------+
  10.  
  11.                 Video Cassette Recorder Movie Data Base
  12.  
  13.                                  by
  14.                          Doctor Disk Drive
  15.  
  16.                     Written in TURBO Pascal v3.01a
  17.  
  18.  
  19.                             USER'S MANUAL
  20.  
  21.  
  22.                                                                 Page 1
  23.                 
  24.                               Contents
  25.  
  26. VCRDBASE
  27.     Table of contents . . . . . . . . . . . . . . . . . . . .   1
  28.     Requirements  . . . . . . . . . . . . . . . . . . . . . .   1
  29.     Description . . . . . . . . . . . . . . . . . . . . . . .   2
  30.     Design & Architecture . . . . . . . . . . . . . . . . . .   3
  31.     Commands  . . . . . . . . . . . . . . . . . . . . . . . .   3
  32.         Init  . . . . . . . . . . . . . . . . . . . . . . . .   3
  33.         Add . . . . . . . . . . . . . . . . . . . . . . . . .   4
  34.         Change  . . . . . . . . . . . . . . . . . . . . . . .   4
  35.         Note on Closest Match . . . . . . . . . . . . . . . .   4
  36.         Delete  . . . . . . . . . . . . . . . . . . . . . . .   4
  37.         Search  . . . . . . . . . . . . . . . . . . . . . . .   5
  38.         Print Labels  . . . . . . . . . . . . . . . . . . . .   5
  39.         Exit  . . . . . . . . . . . . . . . . . . . . . . . .   6
  40.         Backing Up Storage Files  . . . . . . . . . . . . . .   6
  41.  
  42.         
  43.         
  44.         
  45. INTRODUCTION & HARDWARE REQUIREMENTS:
  46.  
  47.         VCRDBASE is a program used by a person who needs an easy and
  48. structured way of keeping track of all the movies he or she has.  VCRDBASE
  49. requires an IBM PC with 64K, and if you wish to use the Print-Out options,
  50. a standard printer which is logically LPT1:.  When the program outputs to
  51. the printer, it writes to the LST: device so if there seems to be some
  52. trouble with your printouts, use the MODE program in DOS to assign logical
  53. names or re-direct output as needed.
  54.  
  55.         To start or invoke VCRdBase, at the DOS prompt, type: VCRDBASE and
  56. press return.  It will load up and take off.
  57.  
  58.         Please be aware that I have not made VCRDBASE trap out for 
  59. incorrect data types.  What this means is, if you enter a alpha-numerical
  60. answer to a integer or real prompt, The program will die.  This is
  61. actually safer as it is, rather than me turning of type checking.  If
  62. it crashes during data entry,  just start the program up again and 
  63. try again, being more careful at the keyboard.
  64.  
  65.         I understand that this exact same package could be written on a
  66. data base program like PC-File, or others in that neighborhood.  When I
  67. wrote this package, I didn't know those packages could do this kind of
  68. thing.  Oh well.  I guess VCRDBASE is still useful to someone who hasn't
  69. bought and learned a database program yet (like me!)
  70.  
  71.                                                                 Page 2
  72.  
  73. DESCRIPTION:
  74.  
  75.     VCRDBASE is a data base written in Turbo Pascal for the IBM PC.
  76. it can be used to keep record of a personal video library by the reference
  77. of the following data elements:
  78.  
  79.                 Movie Name              String[20]
  80.                 Movie Publisher         String[20]
  81.                 Movie Star              String[20]
  82.                 Movie Style             (Horror,Comedy,Action,Drama,Misc.)
  83.                 Movie Sub-Style         (Horror,Comedy,Action,Drama,None)
  84.                 Tape Number             Integer
  85.                 Counter Starter Number  Integer
  86.                 Counter End Number      Integer
  87.                 Tape Speed              (S,L,E)
  88.                 Hard Copy Verification  Boolean
  89.  
  90.     It is usually a good idea to exclude the prefix on most movies of "The"
  91. so as not to mess up the sorting.  If the name is too long for 20 characters, 
  92. it is also a good idea to try to use the useful words in the name to make up 
  93. the entry.  An example would be "TRAIL OF THE DEAD RABBIT". This is 24 
  94. characters long.  A meaningful shortening of this name would be something 
  95. like, "TRAIL, DEAD RABBIT".  
  96.  
  97.     Publisher is usually what you find at the beginning of the movie.  I 
  98. really can't mention any for the sake of copyrights.  The tape number is 
  99. purely an integer so those of you who use the letters included in many types 
  100. of tapes, are out of luck until I find a reason to turn an integer into a 
  101. string throughout the entire package.
  102.  
  103.     Counter Starter Number is usually in the range of 0 to 5800 telling where 
  104. along the tape, the movie starts. This is if you use more than 1 movie per 
  105. tape like me.  Counter End Number is where the movie ends.  You may start 
  106. feeling that you don't want to include this, but it is used in making labels.  
  107. Tape speed should be inputted as the letter 'S','L','E' as you have it set.  
  108. When is is output, the letter you input will precede a letter "p" so don't 
  109. try to input the whole thing, just what is necessary.
  110.  
  111.     Hard Copy Verification is a very handy feature I have decided to include 
  112. in this package.  It allows the person who is managing the dbase to set a 
  113. little flag in the movie record that prevents that record from being printed 
  114. out when the user requests a print of any movies.  This is useful for keeping 
  115. soap opera's, documentaries, or personal tapings apart from the list of movies,
  116. or keeping certain movies from appearing on the printout for the sake of 
  117. privacy.  This flag can be surpassed if the user enters a password to do so.  
  118. This password may be changed if the changer knows the old password.  Be aware 
  119. that this flag has no effect on screen listings but if I receive enough 
  120. requests for such an option, I will include a Visual Verification Flag that 
  121. requires a password from the user, in order to see the movie.  
  122.  
  123.  
  124.                                                                 Page 3
  125.         
  126. DESIGN & ARCHITECTURE:
  127.  
  128.     VCRDBASE is quite unique in that it uses a Linked List data structure for 
  129. record management and sorting.  In this data structure, the Header file, 
  130. HEADER.DAT, contains the record number of the first alphabetical movie. That 
  131. movie (the first alphabetical) contains a forward link and a backward link.  
  132. The forward link contains the record number of the next alphabetical movie and 
  133. the backward link contains the record number of the preceding record (or in 
  134. this case, 0 because there is no previous record)  Adds are made by placing 
  135. the record in the next available file position, and then searching where it 
  136. belongs among the records, and adjusting the links to include the new record.  
  137. It will properly alphabetize all your movies and is remarkably fast in sorting 
  138. compared to many sorting techniques.  The data file, DATAFILE.DAT, contains all
  139. the movie records and neither of the files should be renamed, or physically 
  140. edited because they are both random access files that are accessed by key only.
  141.  
  142.         The Header file also contains the default values for printing labels.  
  143. You can change these values in the PRINT LABELS option.
  144.  
  145.         Do not worry if you end up waiting up to 10 seconds for a record to
  146. be written, when you reach up to entry number 100.  If this package were 
  147. created without the Linked List data structure, you would be waiting up to 30 
  148. to 45 seconds for an entry to be written, and the list stay sorted.  I dare to 
  149. say that a boolean sort might be faster, but if you've got a hard disk, what's 
  150. a few hundredths of a second?  
  151.  
  152.  
  153. COMMANDS
  154.  
  155.         At the Main Menu, (the one with the big letters) there are different 
  156. selections you may choose.  Be wary that this prompt does not require a 
  157. carriage return.  Many prompts in this package are like that, and many aren't.
  158.  
  159.         INITIALIZE:
  160.  
  161.         One such command not mentioned on the Main Menu, is the Initialize
  162. command.  This is a hidden command that allows the user to initialize the two 
  163. data files used by the package.  You shouldn't have to do this because I have 
  164. already included empty data files on this disk for you but in the case that you
  165. happen to lose those files, or mess them up severely, or delete them by 
  166. mistake, you can always revert to this option to make new ones.  (WARNING:  
  167. this option will DELETE any old versions of these data files, so know what you 
  168. want to do before you do it.)  When the computer asks you, "Do you wish to 
  169. Initialize the files? " your answer must be "yes", letter for letter.  For 
  170. those of you who like to take me literally, the answer string consists of 
  171. ascii: chr$(121) chr$(101), and chr$(115).  I am sorry that I have to revert 
  172. to such measures to make myself clear, but you asciied for it!  Any other 
  173. answer to this prompt will cause the computer to ignore you and go back to the 
  174. Main Menu.
  175.  
  176.                                                                 Page 4
  177.  
  178.         ADD
  179.  
  180.         If you wish to make an entry into the data base, Use this option to
  181. do so.  The first question checks if you really want to add something.  If
  182. so, answer the following prompts, making sure that what you input doesn't
  183. exceed the maximum size for that field.  After you have input all needed
  184. information, the computer will display your entry in an output template, and 
  185. ask you if you want to keep it.  If you do keep it, the computer will find a 
  186. place for it, and tell you at which file position, the movie was written. This 
  187. is a good way of finding out how large your file is becoming.
  188.  
  189.         CHANGE
  190.  
  191.         If you happen to make a mistake that you don't catch at entry time,
  192. you can go back and change any element of a movie except the name and 
  193. hard copy verification.  In order to change the name or the Hc-Verify, you 
  194. have to delete the entry from the file, and re-enter it.  Otherwise, if it
  195. was just a star actor/actress whose name you misspelled, or a tape number you 
  196. got wrong, just follow the prompts and everything will be changed as requested.
  197. When selecting a movie to be changed, you must produce the name of that movie 
  198. exactly as it is in the file, or the computer will tell you that it cannot 
  199. find the movie you are looking for.  If you don't remember the name, you can 
  200. use options 1-4 in Search, to find it on the screen.  
  201.  
  202. ( Note:  Installed in the CHANGE, DELETE, and SEARCH TITLE options, is what is 
  203. known as the Closest Match option.  If an exact match is not found in the file,
  204. the computer will ask you if you wish to search for the closest match.  If you 
  205. say Y for yes, the computer will then search for any uppercase matches (titles 
  206. get transformed to uppercase) and matches of the first two characters of the 
  207. title.  After the computer finds a match, It will ask you if you intend to 
  208. continue searching.  If so, It will continue until it passes any alphabetical 
  209. match possibilities. )
  210.  
  211.         DELETE
  212.  
  213.         If you record over a movie and wish to delete it from the data base, 
  214. you can select the Delete option.  You will prompted for the name of the movie 
  215. and as above in the Change option, the name must be exact.  If the computer 
  216. can find the movie, it will display it for you, and then ask if you really want
  217. to delete it.  If so, It will be deleted and all will be peachy.
  218.  
  219.                                                                 Page 5
  220.  
  221.         SEARCH
  222.  
  223.         In this option, you have a world of things to do with your data.  You 
  224. can:  1) Have any movie displayed in front of you in an output template 
  225. (search by Title)  2) Have any group of movies displayed in front of you in 
  226. output templates, (Search by Group "Horror, Comedy, Action, Drama")  3) Output 
  227. all movies in the standard output template (Display all movies) 4) Display a 
  228. listing of all movies, (Display List of All Movies) 5) Print a list of a group 
  229. of movies, 6) Print a List of All movies, and 7) Print a full dissection of 
  230. the Data file and Header file.  The last option is a diagnostics option that 
  231. you will rarely use.  It requires a password for access because it will output 
  232. all information regardless of nature.  The password for option seven is 
  233. "CROSSCARPDIGMAREAPPLES".  I got that from a friend at work who was telling a 
  234. very bizarre joke.    
  235.  
  236.         A final option, (8) is the option to change the Master Pass Code, 
  237. requires the knowledge of the original passcode.  It is an integer no greater 
  238. than 32767 and no less than -32768.  The original passcode is 0.  Be sure to 
  239. change this immediately as if someone changes it, you must initialize all your 
  240. files to get control of it again.  The passcode is not visible when typed to 
  241. help in the privacy department.
  242.  
  243.         PRINT LABELS
  244.  
  245.         This option took some serious work.  This allows you to print out 
  246. labels for your tapes on standard 9/10" x 3.5" labels or bigger.  In 
  247. accommodating for all kinds of labels, I have allowed the option to configure 
  248. your system for they type of labels you have.  You can set the number of 
  249. labels per line, label separation, left column indentation, and
  250. the header that appears on the top of each label.  The labels allow anywhere 
  251. from 1 to three movies per tape.  
  252.  
  253.         When you start this command, you are asked if you wish to create a 
  254. master tape list file.  You will also be advised if you should or not.  If you 
  255. press Y, The computer will then generate a dual-link file listing all tapes in 
  256. the VCRdBase.  100 entries in the Data Base take about 30 seconds to process.  
  257. If you don't, the computer will use the current Tape list file called 
  258. TAPELIST.DAT.  If this file is not up to date, or does not exist, you can 
  259. probably expect the computer to get lost in la la land, or crash with an I/O 
  260. Error 01 or FF (File not found). 
  261.  
  262.         After this, you are asked to specify if you want to print one label, 
  263. a group of labels, or all labels.  
  264.  
  265.         If you choose One label, you will be prompted for the tape number, and 
  266. then asked to verify the Label Print Settings (See below).  Afterwards,
  267. the label will be printed.
  268.  
  269.         If you choose Group labels, You will be given a grid of 24 spots where 
  270. you can select up to 24 tapes to be printed.  The program gives you 
  271. instructions on how to enter the values.  Afterwards, you will be asked to 
  272. verify the Label Print Settings (See below).  Soon after, the labels will 
  273. be printed out.
  274.  
  275.                                                                 Page 6
  276.  
  277.         If you choose All labels, you will be asked to verify the Label Print 
  278. Settings.  These settings are, Left Indentation: Number of spaces that the 
  279. labels are indented on the left edge.  Label Separation: Number of spaces 
  280. between each label.  Number of Labels per Line: What is says.  Header String: 
  281. Message printed on the top of the label.  Afterwards, the labels will begin to 
  282. print.  
  283.  
  284.         The labels will look like this:
  285.               ____________________________Header String
  286.              /
  287.         VCRDBASE Library          1 <-----Tape Number
  288.         -------------------------------
  289.         Rodzina Eats New York    0-3091
  290.         Kroika!               3100-4936 <-Counter End Number
  291.              \                  \_________Counter Start Number
  292.               \___________________________Movie Name
  293.  
  294.         EXIT
  295.  
  296.         After you are finished, select the EXIT command at the main menu
  297. to quit the program and return to DOS.  It is recommended that you place
  298. a copy of COMMAND.COM on the disk this program is on.  It replaces the file
  299. when it is invoked, like all TURBO Pascal programs do.  
  300.  
  301. BACKING-UP STORAGE FILES
  302.         
  303.         A good idea to implement in the use of this package is a batch file
  304. that activates this program, and then makes backup copies of the latest
  305. data files, or if you are really precautious, you can make it back up the
  306. data files before the program is invoked.  Such a batch file would look like 
  307. this:
  308.         
  309.         VCRDBASE                or      Copy *.dat *.bak
  310.         Copy *.dat *.bak                VCRDBASE
  311.         
  312.         Such a practice is handy in case you are accident-prone, or are a
  313. hunt and peck typist, trying to learn not to look at the keyboard.
  314.  
  315.  
  316. FINAL NOTES ON COMPATIBILITY
  317.  
  318.         I have been informed that this package doesn't work on an AT&T
  319. computer.  Evidentally, a file read request is bogus or something to that
  320. effect.  All I can say is; I guess AT&T is not quite as compatible as it
  321. claimed to be.
  322.  
  323.         If you find this package worth while, (or just want to scavenge it
  324. for some select routines) send $10.00 to the below address for a disk 
  325. containing the full source code in Turbo Pascal.  
  326.  
  327.                 Drive Industries.
  328.                 4104 Garrett Pl.
  329.                 Colorado Springs, CO  80907
  330.